home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1999 May / SGI IRIX 6.5 Applications 1999 May.iso / dist / impr_base.idb / usr / share / catman / u_man / cat1 / psdit.z / psdit
Text File  |  1998-05-04  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPSSSSDDDDIIIITTTT((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSDDDDIIIITTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      psdit - convert troff intermediate format to POSTSCRIPT format
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppssssddddiiiitttt [ ----FFFF_f_o_n_t_d_i_r ] [ ----pppp_p_r_o_l_o_g_u_e ] [ ----oooo_l_i_s_t ] [ _f_i_l_e ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _p_s_d_i_t translates a _f_i_l_e created by device-independent troff(_1) to
  16.      POSTSCRIPT format for printing on a POSTSCRIPT printer.  If no _f_i_l_e is
  17.      mentioned, the standard input is used.  The POSTSCRIPT file is sent to
  18.      the standard output.  The options are:
  19.  
  20.      ----FFFF _f_o_n_t_d_i_r
  21.           take font information from _f_o_n_t_d_i_r instead of the default (see
  22.           below).
  23.  
  24.      ----pppp _p_r_o_l_o_g_u_e
  25.           use the contents of _p_r_o_l_o_g_u_e instead of the default POSTSCRIPT
  26.           prologue (see below).
  27.  
  28.      ----oooo _l_i_s_t
  29.           prints pages whose numbers are given in the comma-separated _l_i_s_t.
  30.           The list contains single numbers _N and ranges _N_1----_N_2.  A missing _N_1
  31.           means the lowest-numbered page, a missing _N_2 means the highest.
  32.  
  33.      NNNNooootttteeee:::: the input for _p_s_d_i_t should be prepared with the corresponding ----TTTTppppsssscccc
  34.      option of troff, _p_i_c, etc.
  35.      _e_q_n should be run with the flags ----rrrr555577776666 and ----mmmm2222 to produce suitable
  36.      output.
  37.      _p_i_c should be run with the ----DDDD flag.  With _p_i_c, use ----TTTT555577776666 to set the
  38.      correct resolution.
  39.  
  40.      _p_s_d_i_t allows for users to cause _t_r_o_f_f to include arbitrary POSTSCRIPT
  41.      code in the generated POSTSCRIPT file.  _p_s_d_i_t recognizes the heretofore
  42.      undefined ``%'' command in the troff intermediate file format to signal
  43.      the start of raw POSTSCRIPT to be placed _a_s _i_s in the the output file.
  44.      Everthing between (but not including) the percent sign and a line
  45.      containing a single period (``.'') will be placed in the generated
  46.      POSTSCRIPT output.  This POSTSCRIPT is not insulated from the _t_r_o_f_f
  47.      coordinate system or the state of the generated POSTSCRIPT. However, two
  48.      functions are defined in the prologue so that user's may insulate
  49.      themselves if they so desire.  The PPPPBBBB function (for _p_i_c_t_u_r_e _b_e_g_i_n) will
  50.      perform a POSTSCRIPT ssssaaaavvvveeee operation, translate the POSTSCRIPT coordinate
  51.      system to _t_r_o_f_f'_s idea of the current position on the page, and change
  52.      the scale and orienation of the coordinate system axes to be the standard
  53.      POSTSCRIPT 72 units per inch.  The PPPPEEEE macro (for _p_i_c_t_u_r_e _e_n_d) will end
  54.      this protected environment.
  55.  
  56.      Several methods may be employed to incorporated such included POSTSCRIPT
  57.      into the troff intermediate file.  The ``.cf'' ``.sy'' and ``\!''  _t_r_o_f_f
  58.      commands may be useful.  For example, the following sequence may appear
  59.      in _t_r_o_f_f input:
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPSSSSDDDDIIIITTTT((((1111))))                         IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                          PPPPSSSSDDDDIIIITTTT((((1111))))
  71.  
  72.  
  73.  
  74.           (usual troff input)
  75.           \!%PB
  76.           .cf mypic.ps
  77.           \!PE
  78.           \!.
  79.           (more regular troff input)
  80.      to include _m_y_p_i_c._p_s as an illustration.  This facility is both powerful
  81.      and useful, but indiscriminate inclusion of badly-behaving POSTSCRIPT
  82.      code may be dangerous to your document's health.
  83.  
  84. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  85.      PSLIBDIR
  86.           path name of a directory to use instead of /usr/lib/ps for psdit
  87.           prologue.
  88.  
  89. FFFFIIIILLLLEEEESSSS
  90.      /usr/lib/font/devpsc/* - _t_r_o_f_f default description files for POSTSCRIPT
  91.      virtual device.
  92.      /usr/lib/ps/psdit.pro - default POSTSCRIPT prologue.
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      psroff(1), troff(1), lp(1).
  96.      _A _T_y_p_e_s_e_t_t_e_r-_i_n_d_e_p_e_n_d_e_n_t _T_R_O_F_F Brian W. Kernighan, Bell Laboratories 1982
  97.      _D_o_c_u_m_e_n_t_e_r'_s _W_o_r_k_b_e_n_c_h
  98.  
  99. BBBBUUUUGGGGSSSS
  100.      The versions of _e_q_n and _p_i_c distributed with troff (from AT&T) have the
  101.      device names compiled in (so much for device independence!).  They should
  102.      just read the device description file for the information they need.  You
  103.      must be careful to know which version of _e_q_n you are running or you will
  104.      get undesirable results.
  105.      The B-splines generated by _t_r_o_f_f are drawn with an approximation.  The
  106.      functions DDDD~~~~ and DDDD~~~~~~~~ in the prologue need a little work.
  107.  
  108. NNNNOOOOTTTTEEEESSSS
  109.      POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.
  110.      Documenter's Workbench is a trademark of AT&T Technologies.
  111.  
  112. OOOORRRRIIIIGGGGIIIINNNN
  113.      Adobe Systems Incorporated
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.